Release 10.1A: OpenEdge Development:
ADM and SmartObjects

SmartDataBrowser instance properties

As the first row in Table 2–6 indicates, there are two types of SmartDataBrowsers: dynamic and static. Each has a different set of instance properties and, therefore, different instance properties dialog box.

Dynamic SmartDataBrowser instance properties

Figure 2–3 shows the Dynamic SmartDataBrowser Properties dialog box.

Figure 2–3: Dynamic SmartDataBrowser Properties dialog box

You use the instance properties in this dialog box as follows:

SmartDataObject — This field enables you to choose the SmartDataObject to drive the dynamic SmartDataBrowser.
Edit Displayed field list — This opens a list box that lists the fields in the SmartDataObject that is the SmartDataBrowser’s Data-Source, from which you can select the fields to be displayed in the dynamic SmartDataBrowser.
Edit Enabled field list — This opens a list box that lists the fields in the SmartDataObject that is the SmartDataBrowser’s Data-Source, from which you can select the fields to be enabled for update.
Search Field — If a field is specified, the first line of the SmartDataBrowser’s frame is allocated to a fill-in field in which the application user can enter a value for a search field. The SmartDataObject query is re-sorted automatically by the search field, and on each keystroke entered, the browse is repositioned to the first row in which the specified field has a value greater than or equal to what was typed so far.
Enable — If checked (the default), this enables the dynamic SmartDataBrowser for use.
Layout — This property is disabled for dynamic SmartDataBrowsers.
View — If checked (the default), this makes the dynamic SmartDataBrowser visible.
Down — This determines the number of rows to display in the dynamic SmartDataBrowser.
If this is 0 (zero, the default), Progress calculates the number of rows displayed in the dynamic SmartDataBrowser based on the size of the browser. This might result in the display of a partial row at the bottom of the browse. (You can adjust the height of the browse manually to compensate.)
If this is a positive integer, Progress displays exactly this many rows in the browse. You cannot specify a decimal value, so the browse never displays a partial row.

The value of this property is assigned to the browse’s DOWN attribute.

Calculate Width — This determines the width of the dynamic SmartDataBrowser.
If this is unchecked (the default), the browse’s EXPANDABLE property is turned on, and Progress sets the width of the browse based on the width of the dynamic SmartDataBrowser. In this case, if the width of the browse columns is less than the width of the browse, the last column is expanded to fit the width of the browser.
If this is checked, Progress calculates the exact width of the dynamic SmartDataBrowser’s columns, compares the result with the Max Width value, and uses the smaller of the two values as the width of the browse. Checking this box turns off the browse’s EXPANDABLE attribute.
Max Width — This specifies the maximum width of the browse (the default is 80.00). If you check Calculate Width and the calculated width is greater than Max Width, Max Width is used instead. This field is enabled only when Calculate Width is checked.
Scroll Remote Results List — If checked, this causes the SmartDataBrowser to try to fill the browse with data when you scroll the browser to the end of a batch of records.
Fetch Data to Fill Browse on Reposition to End of Batch — When checked, this is similar to Scroll Remote Results List, except it occurs on a reposition of the browse (as opposed to a scrolling of the browse).

Static SmartDataBrowser instance properties

The static SmartDataBrowser uses the Visual SmartObject Properties dialog box, shown in Figure 2–4.

Figure 2–4: SmartDataBrowser Properties dialog box

You use the instance properties in this dialog box as follows:

Enable — If checked (the default), this enables the static SmartDataBrowser for use.
Note: Do not uncheck (turn off) this property.
Layout — This property is enabled for static SmartDataBrowsers when a custom layout is defined in the SmartDataBrowser master. This box is disabled if there are no custom layouts defined. Its value is the same as the browser's parent layout by default.
View — If checked (the default), this makes the static SmartDataBrowser visible.
Scroll Remote Results List — If checked, this causes the SmartDataBrowser to try to fill the browse with data when you scroll the browser to the end of a batch of records.
Fetch Data to Fill Browse on Reposition to End of Batch — When checked, this is similar to Scroll Remote Results List, except it occurs on a reposition of the browse (as opposed to a scrolling of the browse).